メインコンテンツまでスキップ
バージョン: DAI 25.2

Windows での DAI サイレント インストール、アップグレード、またはアンインストール

このページでは、Microsoft Windows で Eggplant DAI のインストール、アップグレード、またはアンインストールをサイレントに実行する方法について、手順を追って説明します。ここで「サイレント」という用語を使用するのは、グラフィカル ユーザー インターフェイス (GUI) を介したユーザー入力なしでコマンド ラインからこれらのタスクを実行するプロセスを説明するためです。サイレント メソッドは、DAI のインストールを自動化する場合、またはマシンにコマンド ライン アクセスのみがある場合に便利です。

注記

サイレント インストール、アップグレード、およびアンインストール プロセスに対する DAI サポートは、DAI バージョン 7.4 以降で利用できます。

サイレントインストールの仕組み​

DAI サイレント インストールでは、通常のセットアップ プログラムと同じインストーラーを使用しますが、セットアップ プログラム パネルで構成情報を入力するように求められる代わりに、インストーラーの実行時に読み取る ini ファイルで構成設定の値を事前に指定します。この点に留意してください。

通常のインストールとは異なり、標準インストールと詳細インストールの違いはそれほど大きくありません。ここでは、一部の設定に値を入力せずに、標準インストールをサイレントモードで再現する方法を説明します。

注記

サイレントおよび通常のインストールとアップグレードは同等であるため、サイレントでインストールしてグラフィカルにアップグレードすることも、その逆も可能です。アンインストールについても同様です。

Eggplant DAI をサイレントにインストールまたはアップグレードする​

Eggplant DAI Windows インストーラーは以下をサポートします:

  • 新規インストール
  • 以前のサポート バージョンからの増分 アップグレード (サポートされるバージョンの完全なリストについては、[リリース ノート](./dai-release-note 注記s.md) を参照してください)。
注記

ダウングレードはサポートされていません。

ステップバイステップ: サイレントインストールを実行する​

新規インストールまたは既存の DAI インストールのアップグレードには、これらの手順を使用します。

  1. Download the Eggplant DAI Server installer。

  2. アップグレードの場合は、インストールする前に DAI Windows サービスを停止する必要があります。

  3. DAI データ フォルダ C:\ProgramData\Eggplant\Digital Automation Intelligence\silent.ini に silent.ini ファイルを作成します。

    注記

    新規インストールの場合は、C:\ProgramData\Eggplant\Digital Automation Intelligence ディレクトリを作成する必要があります。DAI は Windows の local system アカウントで実行されるため、このアカウントに Digital Automation Intelligence ディレクトリへの書き込み権限があることを確認する必要があります。

  4. silent.ini ファイルに構成設定を入力します。以下の Silent Install Configuration Settings を参照してください。

  5. 管理者権限でコマンド シェルを起動します。たとえば、Windows の Start メニューをクリックし、Search ボックスに CMD と入力し、Command Prompt を右クリックして、コンテキスト メニューから Run as Administrator を選択します。

    注記

    DAI が正しい権限でインストールされるように、管理者権限 (上記の手順で説明したように Run as Administrator) でインストールを実行することをお勧めします。

  6. 次のコマンドを使用してコマンド プロンプトからインストーラーを実行するか、自動インストールの場合はバッチ ファイルでコマンドを使用します。

    <file path to >eggplantDAI-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="C:\ProgramData\Eggplant\Digital Automation Intelligence\install.log"

    ここで、<file path to> は DAI Server インストーラ実行ファイルへのファイル パス、eggplantDAI-<version>.exe はダウンロードして実行しているインストーラのバージョンです。/VERYSILENT フラグはサイレント タイプのインストールであることを指定します。/SUPPRESSMSGBOXES はメッセージ ボックスが表示されないことを指定します。/NORESTART はインストーラがホスト Windows マシンを自動的に再起動しないことを指定します。インストール後に Windows ホスト マシンを再起動する必要があることに注意してください。/NORESTART フラグを使用すると、再起動を制御できます。

    注記

    インストーラーの実行にはかなりの時間がかかることがありますが、コマンド シェルにステータスは報告されません。ただし、インストーラーの進行状況の詳細を出力する install.log ファイルを確認することで、インストールの進行状況を監視できます。インストーラーは、発生した問題もログ ファイルに報告します。たとえば、構成ファイルに無効な値が含まれている場合、インストーラーはログ ファイルに問題を報告します。プロセスの終わり近く、DAI サービスが起動し、アップグレード移行が実行されている間、最大 10 分間、ログ ファイルに制限されたアクティビティが表示されます。

  7. インストールが完了すると、インストールログに「スタートアップレポートがC:\ProgramData\Eggplant\Digital Automation Intelligence\logs\startup_service.htmlに書き込まれました」というメッセージが表示されます。このDAI Windows Service Start-up Reportには、正常に開始されたサービスがリストされます。スタートアップレポートにDAI services are started successfullyと表示されたら、インストールが成功したことがわかります。起動中に発生したエラーもここに詳細に記録され、

  8. インストール プロセスを完了するには、マシンを再起動します。インストーラー コマンドで /NORESTART 設定を使用して、Windows を自動的に再起動しないように指定しているため、これが必要になります。

サイレントインストールの構成設定​

.ini ファイルの構造​

サイレント インストールおよびアップグレードを行うには、silent.ini ファイルを作成する必要があります。以下に、silent.ini ファイルに関する情報と、システムに合わせてコピーして変更できるサンプルを示します。

注記

アンインストールには silent.ini ファイルは必要ありません。

有効な silent.ini ファイルを作成するには、次のルールが適用されます。

  • ファイルには [settings] という名前のセクションが 1 つ必要です。
  • 必要な設定は、以下の [Fresh Install]](#fresh) および Upgrade セクションで定義されています。アップグレードの場合は、必要な設定が少なくなります。
  • すべての設定の行をファイルに指定する必要があります (機密値を除く。以下の Secrets を参照)。
  • 一部の設定はオプションです。たとえば、https_cert_path= の設定では、この設定に値は提供されません。
  • ブール型の Yes/No 設定は、0 または 1 として表されます。たとえば、use_https=0 の設定では、HTTPS ではなく HTTP が使用されます。
  • サイレント インストールでは、通常のインストールと同じ検証ルールが使用されます。有効なルールと無効なルールの詳細については、Windows Install Guide をお読みください。

シークレット​

Eggplant DAIのインストールプロセスでは、ユーザー名とパスワードの指定が必要です。有効な管理者名については、標準インストールの実行をご覧ください。

silent.ini ファイルでユーザー名とパスワードを指定できますが (詳細は下記を参照)、セキュリティ上の理由からこれはお勧めしません。代わりに、これらの設定を除外し、同等の環境変数を介して設定することをお勧めします。

同等の環境変数は同じ名前を持ちますが、すべて大文字です。たとえば、dai_admin_username は DAI_ADMIN_USERNAME 環境変数を使用して設定されます。これは以下に適用されます。

  • DAI_ADMIN_USERNAME: DAI管理者のユーザー名
  • DAI_ADMIN_PASSWORD: DAI管理者パスワード
  • KEYCLOAK_ADMIN_USERNAME: (Keycloak) システム管理者のユーザー名
  • KEYCLOAK_ADMIN_PASSWORD: (Keycloak) システム管理者のパスワード
注記

これらの環境変数を設定するときは、機密データがコマンド シェルの履歴に漏洩しないように注意してください。理想的には、組織のシークレット マネージャーでこれらの設定を指定し、環境変数を設定できるようにする必要があります。

新規インストール​

Eggplant DAI の新規インストールを実行するには、以下に示すような silent.ini が必要です。以下の例は標準インストール用であり、高度なインストールでは、この例で空になっている設定の一部またはすべてを入力する必要があります。

[settings]
pgsql_data_directory=C:\ProgramData\Eggplant\Digital Automation Intelligence\data
server_port=8000
use_https=0
https_cert_path=
https_key_path=
https_server_name=
https_key_requires_password=0
https_key_password_file_path=
report_usage=0
minio_data_directory=C:\ProgramData\Eggplant\Digital Automation Intelligence\minio
server_name=localhost
keycloak_firstname=dai
keycloak_lastname=dai
keycloak_email=dai@keysight.com
# some or all of the following 4 settings can be removed from this file and replaced with equivalent environment variables \{#some-or-all-of-the-following-4-settings-can-be-removed-from-this-file-and-replaced-with-equivalent-environment-variables}
dai_admin_username=admin
dai_admin_password=AdminPassword
keycloak_admin_username=sys_admin
keycloak_admin_password=SysAdminPassword

各フィールドは、グラフィカル インストール プロセスの同等のフォーム フィールドにマップされます。

設定グラフィカルインストーラーでの同等の設定インストールタイプ
pgsql_data_directoryPostgresQL データディレクトリ高度な設定
server_portサーバーポート高度な設定
use_httpsHTTPS (チェックボックス)高度な設定
https_cert_pathHTTPS 証明書高度な設定
https_key_pathHTTPS 秘密鍵高度な設定
https_server_nameNot used高度な設定
https_key_requires_password秘密鍵にはパスワードが必要です（チェックボックス）高度な設定
https_key_password_file_path秘密鍵パスワードファイル高度な設定
report_usage使用状況統計（チェックボックス）高度な設定
minio_data_directoryスイートデータディレクトリ高度な設定
server_nameDAI サーバーホスト名標準
keycloak_firstnameDAI 管理者名標準
keycloak_lastnameDAI管理者ユーザー名標準
keycloak_emailDAI 管理者のメールアドレス標準
dai_admin_usernameDAI管理者ユーザー名標準
dai_admin_passwordDAI管理者パスワード標準
keycloak_admin_usernameシステム管理者のユーザー名標準
keycloak_admin_passwordシステム管理者のユーザー名標準

アップグレード​

Eggplant DAI の既存のインストールをアップグレードするには、以下に示すような silent.ini ファイルが必要になります。

[settings]
# 以下の 4 つの設定の一部またはすべてをこのファイルから削除し、同等の環境変数に置き換えることができます \{# 以下の 4 つの設定の一部またはすべてをこのファイルから削除し、同等の環境変数に置き換えることができます 1}
dai_admin_username=admin
dai_admin_password=AdminPassword
keycloak_admin_username=sys_admin
keycloak_admin_password=SysAdminPassword

Eggplant DAI をサイレントアンインストールする​

アンインストーラーの動作の詳細については、通常の アンインストール ページを参照してください。

Eggplant DAI をインストールすると、インストーラーによってインストール ディレクトリ (例: C:\Program Files\Digital Automation Intelligence\unins000.exe) に unins???.exe (通常は unins000.exe) という名前のアンインストーラー ファイルが作成されます。

再度、アンインストーラーを管理者権限で実行する必要があります。サイレントモードで管理者として実行するには、以下の手順が必要です。

  1. 管理者権限でコマンドシェルを起動します。たとえば、WindowsのStartメニューをクリックし、SearchボックスにCMDと入力し、Command Promptを右クリックして、コンテキストメニューから管理者として実行を選択します。

  2. システムに作成されたアンインストーラー ファイルの名前を使用して、次のようなコマンドでアンインストーラーを実行します。

    <file path to>unins000.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="C:\ProgramData\Eggplant\Digital Automation Intelligence\install.log"

    ここで、<file path to> は DAI サーバーのアンインストーラ実行可能ファイルへのファイル パスです。

に最終更新